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ee ee ee ee ee ee ee ee ee ee” ee ee ee ee eee ee ee ema 


NO 


Lacs Driver Megabus Services | Component Specification 


TABLE OF CONTENTS 
PAGE 

REFERENCES a 3 
INTRODUCTION AND OVERVIEW 


> 


BACKGROUND 

BASIC PURPOSE 

BASIC STRUCTURE 

BASIC OPERATION 

DETERMINATION ROUTINE 

DETERMINATION ROUTINE ERRORS 

ISSUE IORL ROUTINE 

ISSUE 1OLD ROUTINE ERRORS 

ISSUE 10 ROUTINE 

ISSUE 10 ROUTINE ERRORS 

INTERRUPT PROCESSING ROUTINE 
INTERRUPT PROCESSING ROUTINE ERRORS 
FLOW CONTROL ROUTINE 

PRE LCB FLOW CONTROL ROUTINE 

PRE LCB FLOW CONTROL ROUTINE ERRORS 
POST LCB FLOW CONTROL ROUT.INE 

POST LCB FLOW CONTROL ROUTINE ERRORS 
NAK'D ROUTINE 

NAK'D ROUTINE ERRORS 


® e e e 


PARA RAL AHR AA RRA BRAWN — 


e 
mad 


e © e ® e #® © @ «6 
ee «© e© @ ee @ 
NANnUUUO UW UIP BP OWA DA — 
e e e e | 
e 


OW WU WO UO DWODAOWDANxANAINANA HAL 


® 
canenalds 


EXTERNAL SPECIFICATION 


\O 


OWNED DATA STRUCTURES 

EXTERNAL INTERFACES 

MOD400 EXECUTIVE SOFTWARE ROUITNES 
1 ZXREQ 

.2 ZHCOMM 

3 ZXD_PR 

MOD400 DATA STRUCTURES IMPLEMENTED 
USER INTERFACES 

1 LDMS INTERFACE 

.2 LCB FORMAT 

INITIALIZATION REQUIREMENTS 
TERMINATION REQUIREMENTS 

ENV | RONMENT 

TIMING AND SIZE REQUIREMENTS 17 
ASSEMBLY AND LINKING 17 
TESTING CONSIDERATIONS 17 
DOCUMENTATION CONSIDERATIONS 17 
ERROR MESSAGES 17 
INTERRUPT PROCESSING ERRORS | 17 


e @ 


~~ —- 109 @M~A A UW HWP DH NN NH HD PD Lh — 


oO O 
e 


ce eee eh eh em om mk meh UL) 
AANA" ODOOAOVDODOAO00 0 


e e oe e e 6 e se 


DODD BD PD DN DN PD PD PD NN LHD PD DP fA bo 


Lacs Driver Megabus Services 


eee | 
Dee 
See 
Seles 
Bele 
3.2.4 
52249 
D2 6 Oe) 
oe are eee | 
3.2.6 
4 
5 


INTERNAL SPECIFICATION 


OVERVIEW 

SUBCOMPONENT DESCRIPTION 
DETERMINATION ROUTINE 

ISSUE I!OLD ROUTINE 

ISSUE 10 ROUTINE 

INTERRUPT PROCESSING ROUTINE 
FLOW CONTROL ROUTINES 

PRE ORDER FLOW CONTROL ROUTINE 
POST ORDER FLOW CONTROL ROUTINE 
NAK'D ROUTINE 


PROCEDURAL DESIGN LANGUAGE 


ISSUES 


Component Specification 


Lacs Driver Megabus Services Component Specification 


REFERENCES 


Li] CLM User Extensions, Richard Taufman, May 14,1979. 


[2] Engineering Product Specification (H/W), Local Area Controller 
Subsystem (LACS), Rev F, A. C. Hirtle, Oct 4, 1984. 


L3J Engineering Product Specification, LAN Software, R. Dhondy, 
Aug. 16, 1985. 


[4] LAN S/W Component Specification, System Management, 0D. 
O'Shaughnessy 
Aug. 16, 1985. 


[5] LAN S/W Component Specification, LACS Driver Interface Services, 
P. Stopera, Aug. 16, 1985. 


[6] LAN S/W Component Specification, LACS Driver Megabus Services, 
P. Stopera, Aug. 16, 1985. 


C7] Lan S/W Component Specification, Configuration Requirments 
L. Vivaldi, Aug. 16, 1985. 


[8] LAN S/W Component Specification, LACS Link Layer Protocol, H. King 
Aug. 16, 1985. | 


C9] L6 LAN Data Structures, P. Stopera - Aug. 16, 1985 


Lacs Driver Megabus Services Component Specification 


1. INTRODUCTION AND OVERVIEW 


C, 


1.2 


BACKGROUND 


The lacs driver megabus services (Ildms) IS a component of the 


lacs driver [fn the lan subsystem. The Idms fs the lacs driver's 
interface to the lacs via the !I6 megabus. The Idms fs used by 
the lacs driver's layer servers (Ils) when they wish to send [fo or 
ijold requests to the lacs. 


BASIC PURPOSE 


The !dms has several purposes, they are: to [Issue fold's to the 
lacs, to process Interrupts from the lacs, to issue fo'ts to the 
lacs, to mafntain flow control at the controller level and to 
process nak'd fo's, 


BASIC STRUCTURE 


Figure 1 shows the relation of the Idms to the other components 
of the lacs driver. Figure 2 shows the subcomponents of the 
[dms. The following [s a brief description of the functions of 
each subcomponent of the Idis: 


determination routine - This routine determines whether to 
call the Issue jo or fssue fold routine. The determination 
is made from the Input parameters. The routine jis also 
responsible for returning to the calling routine. 


Issue fold routine = This routine will [ssue an fold to the 
lacs. The buffer address and range [In the fold represent 
the lan control block (lIcb). The Icb fs supplied as an 
Input parameter when the Is calls the Idms. The routine ifs 
also responsible [n queuing Icbs on the IIt, checking 


controller states, calling the flow control routine, and 
handling naks by the megabus. 


issue fo routine =- This routine will [Issue an fo to the 
lacs. The function to be performed is supplied as an input 
Parameter when the Is calls the Idms. The routine [fs also 
responsible for checking controller states and handling naks 
by the megabus. 


interrupt processing routine =- This routine [s responsible 
for handling Interrupts from the lacs. The Interrupts will 
be a result of the lacs completing a Icb. The routine wil! 


dequeue completed Icbs off the IIit queue, call the flow 
control routine, and depending on how the [cb [s set up the 
routine will Inj to the Is which [ssued the Icb to the Idms, 


or perform a task request, or release the Icb's memory. 


flow control routine = This routine [Is responsible for 
maintaining the count of Icbs outstanding at a controller. 
The routine will queue Icbs {ff the controller limits are 
exceeded, and dequeue and [ssue [cb via a call To the I[ssue 
lold routine when the limits recede. 


a 
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LAN L6 SOFTWARE ARCHITECTURE 
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LACS DRIVER MEGABUS SERVICES SUBCOMPONENTS 


> GED GED GS o> aD GED GP OE OE GP a GP Ge GD OD GD 6D GD GG Ga 2 GG 6D GD Ge Ge GP 4 Gp GD 2s 2B Gp GS Gp ae os an am 


figure 2 


Lacs Driver Megabus Services Component Specification 


nak'd routine - This routine Is responsible for processing a 
lo or told which was nak'd an excessive amount of times 
during processing of the Issue fo or issue fold routines. 


1.4 BASIC OPERATION 


1.4.1 DETERMINATION ROUTINE 


The determination routine will be Invoked via a Inj from a 
routine wishing to Issue a fo or fold to the controller. The 
routine will save the return address. The routine will then 


validate the Input parameters, returning to the calling routine 
if any of the parameters are Invalid. Then using the [Input 
parameters the routine determines whether to call the [Issue fold 
or f[ssue fo routine. The call to the [ssue routine Is a Inj, the 
Issue routines are expected to return to the determination 
routine. Upon return from a issue routine the determination 
routine will retrieve the saved return address (of the Is), then 
wi!l return to the caller with a status which was set up by the 
issue routine. 


1.4.1.1 DETERMINATION ROUTINE ERRORS 
Errors reported by the Idms determination routine are: 


1. Invalid Input parameters when the routine Is 
called. 


1.4.2 {ISSUE I|OLD ROUTINE 
This routine Is Invoked via-a Inj from the determination 


routine. The routine saves the return address. The routine willl 
call the flow control (fc) routine, If the fc routine return with 


an error status, the [ssue fold routine will return to the 
determination routine with the error message from the fc 
routine. The routine will next check the controller state, If 
the controller is tn the Otherwise, the routine will set up the 
registers for the fold, using [Information In the Icb, the nak'd 
retry count Is reset, and the fold fs issued. If the fold Its 
nak'd the routine will set the controller Into a nak'd state, 
Increment the retry count, then try the fold again. If the fold 
is nak'd repeatedly, the nak'd routine will be called. If a 


nak'd fold is successful the controller Is placed out of the 
nak'd state and a successful return to the determination routine 
is performed. If the fold Is successful a return to the 
determination routine Is performed. 
1.4.2.1 [ISSUE IOLD ROUTINE ERRORS 
Errors reported by the [Issue fold routine are: 


1. The flow control routine return with an error. 


2 fold Is nak'd. | oo 
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1.4.3 ISSUE 10 ROUTINE 


kw The [ssue lo routine Is invoked via a Inj from the 
determination routine. The routine saves the return address. 
The routine will issue the Io using the supplied Input 
parameters. If the fo Is nak'd, the routine will retry the Io a 
set number of times until the fo Is successful or the |Iimit of 
retrying the fo [s reached. If the retry Ifmit was exceeded the 
routine will call the nak'd routine. Otherwise, a successful 
return to the caller (determination routine) fs done. 


Note, If a Input Id fo fs sent to a controller which fs in a 
active state (Il.e. ready to recieve fold's) the controller wil! 
hang, therefore the state of the controller must be checked 
before sending an Input Id. 


1.4.3.1 ISSUE 10 ROUTINE ERRORS 


Errors reported by the issue fo routine are: 


ee lo is nak'd. 
1.4.4 INTERRUPT PROCESSING ROUTINE 


The Interrupt processing routine Is [Invoked via a Interrupt 
from the lacs. The lacs Interrupts when It has completed a Icb. 
The routine will retrieve the Interrupt control word (word 0 of 
™ the Interrupt level tcb). From the Icw bits the routine wil! 
( obtain the pointer to the |Iit In which the completed Icb Is 
queued. The queue of Icb's is searched until a completed Icb is 
found. When found the Icb [Is dequeued from the active Icb 
queue. The pointer to the next Icb In the queue [Is saved, and 
the flow control routine Is called. Upon return from the fe 
routine, the interrupt processing routine will perform the 
function specified In the 16 portion of the Icb. The options 
are: performing a task request, performing a Inj to a layer 
server routine, or nothing. After the routine performs the 
speciffed request, the pointer to the next Icb In the queue Is 
retrieved, then the list Is searched until another completed Icb 


Is found or the end of the queue Is reached. If another 
completed Iicb is found, the routine will repeat the above steps 
until the end of queue Is reached. If the end of the queue ifs 
reached, the level will be exited via a lev Instruction. 


1.4.4.1 INTERRUPT PROCESSING ROUTINE ERRORS 
Errors reported by the interrupt processing routine are: 
re lcw = 0. 
1.4.5 FLOW CONTROL ROUTINE 


There are 2 flow control routines called the pre Icb flow control 
“routine and post Icb flow control routine. 
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1.4.5.1 PRE LCB FLOW CONTROL ROUTINE 


The pre Icb fc routine Is Invoked via a call from the Issue 
fold routine. The routine will test if a Icb can be sent fo this 
controller, this check is done through counts kept [In a lan data 
sturcture. If the controller has sufficent resources the pre Icb 
fc routine will Increment the fold count, then return to the 
issue fold routine with an successful status. If an fold can not 


be sent to the contro 
walt queue and return 
status. 


ller, the routine will queue the [cb on a 
to the Issue [old routine with an error 


1.4.5.1.1 PRE LCB FLOW CONTROL ROUTINE ERRORS 


Errors reported by the pre lcb flow control routine are: 


1. Leb queued 


because of flow control. 


1.4.5.2 POST LCB FLOW CONTROL ROUTINE 


The post Icb fe routine Js Invoked via a call from the 


interrupt processing 
found. The routine w 
controller, then [{f t 
routine will dequeue 
Idms determintion rou 
processing routine. 
routine will return t 
after decremting the 


routine after a completed Icb has been 

ill decrement the iold count for the 

here are any Icb waiting to the sent the 
the head Icb off the walt queue, call the 
tine, then return to the interrupt | 
Otherwise, If there are no Icb waiting the 
o the interrupt processing routine with 
controller fold count. | 


1.4.5.2.1 POST LCB FLOW CONTROL ROUTINE ERRORS 


Errors which are reported by the post fe routine are: 


Ls The Idms r 
1.4.6 NAK'D ROUTINE 


The nak'd routine Is 


eturns with an error. 


invoked via a call from the [Issue [0 or 


issue fold routines when an fold has been nak'd, lf the fold was 
Issued (i.e. the Told went through on subsquent tries) the 


routine will [Issue all fold queued on the nak'd queue off the 
controller directory, then return to the calling routine. If Th 
elold was not Issued, the routine will call the sm Is. Upon 
return from the sm Is the routine will return to the calling 


routine. 


1.4.6.1 NAK'D ROUTINE ERRORS 


Errors which may occur In processing nak'd fo orders are: 


= Sm |s returns with an error. 


2 EXTERNAL SPECIFICATIONS 


2.1 OWNED DATA STRUCTURES 
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The following pages define the data structures owned and used by 
the lan subsystem: 


2.2 EXTERNAL INTERFACES 
2.2.1 MOD400 EXECUTIVE SOFTWARE ROUTINES 
2.2.1.1 ZXREQ - Request task 

entry: Inj $b5,zxreq 


Input: $b4 address of task request block 


$b5 return address 

output: $r1 = 0 - task request was queued successfully 
$r1 > 0 - task request was not queued : 
$b4 = address of task request block 


modifies: $r1,$r2,$r3,$b1,$b2,$b3 


function: Request a normal task with a suppIlled request block 
pointer. 


2.2e1-2 ZHCOMM =- Null address 


function: WII! load the nul! address when referenced i.e. |Idb 
$b5,<zhcomm will toad $b5 with the null address. 


es a} 


2.2.1.3 ZXD_PR - Dequeue and post IRB 
entry: Inj $b5,zxd_pr 


Input: $r2 completion status for request 


$b5 return address 
output: $ri1 = 0 - request was dequeued and posted 
$r1 > 0 = no request on queue exist 


2.2.2 MOD400 DATA STRUCTURES IMPLEMENTED 


The following system owned data structures are referenced by 
the Idms: 


Task Control Block (TCB) 
System Control Block (SCB) 


2.2.5 USER INTERFACES 


2.2.5.1 LDMS INTERFACE (MSI 1!0OR) 


d ox 
-, 


call: Inj $b5,mstior 


me 1 
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input: $b1 = a(lcb) 
$r1 = function code : 
0009 = output Icb —_ 
000x - reset/halt SY 
000x - load/dump 
0001 - strar Io 
0026 - Input id 
$b1 = a(lcb) If function code = 9 
$b1 = a(lit) If function code <> 9 
$b5 = a(return) 
output: $r1 = status 
0000 - fo or told was successful 
0001 - fo or fold was nak'd 
0002 = fold not performed, Icb queued because of 
flow control 
ffff - iInvlaid function code | 
$r2 = hardward Id [If function code = Input [Id on input 
$b1 = aClit) or alicb) 
modiffes: $r2, $ri 
2.2.3.2 LCB FORMAT 
cb pri 
Input: mbz 
output: na 2 
cb_neb NN 
input: mbz 
output: na 
cb orct 
Inputs: address of caller's rect 
outpuT: same as Input 
cb_lit 
input: address of the IIit In which this Icb will be 
queued 
Output: same as Input 
cb_frw 
Input: bit 0-3 = 9 
bit 4-7 = mbz (forb major function code ?) 
bit 8-f - xx 
output: same as inpuf 
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cb_itp 


Cc Inputs: 


Output: 


cb_ind 


InpuT: 


output: 


cb_Iicw 


Input: 


Output: 


cb_fsf 


Input: 


outpuf: 
cb_cts 


Inputs 
outpufT: 


address of the post processing 


on null 


same as [Input 


Indicators 
bit 7 - cb_Itp 


Component Specification 


routine, or trb, 


points to a trb when set 


bit 6 = sm Icb when set 

all other bits mbz 
same as Input 
bit 0-5 = mbz 
bit 6-9 = cpu number to Interrupt 
bit a-f - level to Interrupt the cpu 
Same as [Input 


function specific function code 


function codes 
0012 - 
0022 - 
0042 - 
function codes 
0011 = 
0021 - 
0042 - 
function codes 


for read Icbs are: 
cl! read 

co read 

co expideted read 
for write Icbs are: 
cl write 

co write |. | 
co expideted write 
for event Icbs are: 


OOle - sap event 
002e =- connection event 
004e - sm event 
same as InpuTf 
mbz 
bit O-7 - rfu and mbz 
bit - Invalid function code when set 
bit - ram memory exausted when set 


= ram location non-existent when set 
ram parity error when set 


- level 6 
= level 6 
- level 6 


memory yellow when set 
memory non-existent when set 
bus parity error when set 


ao 
+ 
+O2anwgonowo 
‘ 


- level 6 memeory red when set 
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cb_ 


cb_ 


cb_ 


cb_ 


cb 


cb_ 


cb 


fss 


Inputs: 
outpuT: 


cbs 


Inputs 
output: 


abs 
input: 
OoutpufT: 
lsa 


input: 
output: 


lra 
inputs 


Output: 


Trg 


inputs: 
outpufT: 


bet 


iInpuT: 
output: 


mbz 


function 


0001 
0002 
0004 
0008 
0020 
0040 
0080 
0100 
0200 
0400 
0800 


mbz 
bit 0 = 
bit 1 = 


mbz 
actua| 
same as 


logical 
same as 


logical 


Component 


specific status 


sap not active 

lack of resources 
controller unavailable 
sm layer [nstance error 
sap already active 

sap already deactivated 
recieve buffer too smal| 
illegal logical address 
Invalid Icb 

write credit violations 
read credit violations 


Icb is complete when set 


Specification 


[cb not processed when set 
bit 2-f - rfu and mbz 


buffer size if cb_fss = 0080, otherwise 
Input 
local address for cl operations 
input 


remote address for cl 


for event and read operations 


logical 


remote address for cl read 


otherwise same as [nput 


total byte range 


same as 


Input 


number of buffers 


same as 


input 


- 13 = 


write operation, mbz 


operations, 
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aed 
( . 
, : 


cb_ad] 


Input: 
output: 


—cb_rg! 


Input: 
outpufT: 


cb _rsi 


input: 
output: 


cb_ad2 


inputs 
output: 


cb_rg2 


Input: 
Output: 


cb rs2 


Input: 
outpuT: 


cb_ad3 


Input: 
output: 


cb_rg3 


InpuT: 
outpuT: 


cb _rs5 


input: 
outpuf: 


cb_ad4 


Input: 
output: 


cb rg4 


input: 
outpuT: 


buffer #1 address 
same as Input 


buffer #1 range 
same as [Input 


mbz 


buffer #1 residual range 


buffer #2 address 
same as Input 


buffer #2 range 
same as [Input 


mbz 


buffer #2 residual range 


buffer #3 address 
same as [Input 


buffer #3 range 
Same as Input 


mbz 


buffer #3 residual range 


buffer #4 address 
same as I[npuT 


buffer #4 range 
Same as Input 


a 
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cb_rs4 


Inputs 
output: 


cb_ad5 


Inputs 
outpufT: 


cb rg) 


Inputs 
outpuT: 


cb ors5 


Input: 
output: 


cb_ad6 


Inputs 
output: 


cb_rg6 


Input: 
output: 


cb _rs6 


input: 
output: 


cb_ad7 


Inputs 
ouTtTpuT: 


cb rg/ 


input: 
outpuT: 


cb _rs/7 


Input: 
output: 


cb_ad8 


input: 
output: 


mbz 
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buffer #4 residual 


buffer #5 address 


Same as 


buffer #5 range 


same as 


mbz 


Input 


Input 


buffer #5 residual 


buffer #6 address 


same as 


Input 


buffer #6 range 


same as 


mbz 


input 


buffer #6 residual 


buffer #7 address 


same as 


input 


buffer #7 range 


same as 


mbz 


Input 


buffer #7 residual 


buffer #8 address 


same as 


input 


>= 


range 


range 


range 


range 
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( a 


cb_rg8 
Input: buffer #8 range 
Outpuf: same as [Input 
cb_rs8 
Input: mbz 
output: buffer #8 residual range 


The rest of the Icb flelds are function specific flelds, there 
defintion can be found [In the Idis, Ile Is or the cl4 Is or the 
sm is. 


INITIALIZATION REQUIREMENTS 


The clm process will load the Idms into system memory, and 
configure at least one Interrupt level for the Idms to execute 
under. The Idms bound unft will be loaded Into memory by clim via 
a task request. At this time the Idms will begin executing it's 
Initialization code. The Idms Ist code consists fo performing 
the following: 


1. Posting the task request, using a call to the zxd_pr 
routine. ‘ 

ra Since the levels the Idms Interrupt processing code 
executes under will only be Invoked as a result of an 


Interrupt, the fixed to level bit (mt_fix) In the 
teb's first Indicators word (t_Ind) must be set. 


a Exit the level via a lev enable instruction, leaving 
the p-counter at the entry point of the interrupt 
processing routine. 

TERMINATION REQUIREMENTS 


There are no termination requirements since the Idms will be 
active as long as the mod400 operating system Is active. 


ENVIRONMENT 


The following Items are required by the Idms for it to 
perform IT's task: 


1. Mod400 operating system. 

24 Any 16 computer model except 6/10 and 6/20. 

Ds Lan clim. 

4. A lacs attached to the 16 megabus. 

4 A user of the lan subsystem to drive the lacs driver. 


- 16 = 
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2.6 TIMING AND SIZE REQUIREMENTS 
) “—S 
Currently memory usage and timing requirements are not an yp 
Issue. However, the code should be be as efficient as possible 
(note: the Interrupt processing routine executes at a low level, 
and care should be taken [!n writing the code to make if very 
efficient). 
2.7 ASSEMBLY AND LINKING 
The software will be written in Series 6 Assembly Language 
using a subset of the instruction set that Is present on al! 
Serfes 6 systems. The Idms will be linked with the lacs driver 
Interface services module by the gcos6 mod400 |inker to produce a 
portion of the lacs driver's bound units. The name of the module 
will be zqlims. 
2.8 TESTING CONSIDERATIONS 
Since the product is new, all functions wild be tested by 
the developer, and software test. 
2.9 DOCUMENTATION CONSIDERATIONS 
The Idms source listing will Include a program design 
language used by the developer to ald In the maintenance by 
future developers and also to aid [n the development by the 
developer. | a 
2.10 ERROR MESSAGES _ 
The I[dms will [Inform the calling layer server of an error by 
placing Into $ri the error message, then returning to the calling 
routine. 
ee $r1 = 0001 - Io or fold was repeatedly nak'd. 
ya $ri = 0002 - Icb queued because of flow control. 
a's $r1 = 0000 - fo or fold was successful. 
4, $ri= ffff - Invalid function code. 
2.10.1 INTERRUPT PROCESSING ERRORS 
ae lcw = 0 
3 INTERNAL SPECIFICATION 
3.1 OVERVIEW 
There are 2 ways to activate the Idms code, they are: 
1. A layer server requests an {fo or fold be sent to the oo 
lacs. 7 GY 


a 
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( : An tnterrupt is generated by the lacs. 
3.2  SUBCOMPONENT DESCRIPTION 
Deals DETERMINATION ROUTINE 


The routine [fs [nvoked via a call from a Is wishing to [fssue an 
lcb. The routine requires the following Input parameters: 


$r1 = function code 
0009 = output [cb 
0001 - start ft/o 
000x - load/dump 
000x - reset/halt 
0026 - Input Id 


$b1 = a(licb) {[f function code = 9 
$b1 = aClit) If function code <> 9 
$b5 = 


return address 
The routine supplies the following output parameters: 


$ri1 = status 
0000 - fo or fold was successful 
0001 = fo or fold was nak'd 
0002 - told not performed, Icb queued because of fe 
ffff - Invalid function code 
a $r2 = hardware Id if function code = Input Id upon Input 
( $b1 = a(lcb) | | 


When the determination routine is invoked by a Is the routine 
performs the following: 


1. Validates the function code, returning to the caller 
if the function code Is no In the allowable range. 


2% Saves the return address. 


a. Depending on the function code, the routine calls 
elther the [Issue fold routine or [ssue fo routines. 


When the determination routine is [Invoked by either the Issue 
fold routine or ftssue Io routine, the routine performs the 
following: 
1. Retrieve the return address. 
L% Jumps back to the Is. 
3.2.2 ISSUE [OLD ROUTINE 


The Issue fold routine [Is called by the determination routine. 
The routine requires the following input parameters: 
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$r1 = function 
0009 = output Icb 7 | es 
0001 = start fo | MY 

| 000x = load/dump 
- $b1 = a(lcb) 
$b5 = return address 
The routine supplies the following output parameters: 

$ri.= status 
0000 - iold was successful 
0002 - fold not issued, Icb was queued because of fc. 
0001 =- fold not ftssued because of success nak'd 

$b1 = a(icb) 

The routine performs the following function: 

1. Save the return address 

2. Retrieve the pointer to the IIt from the !cb (cb_lit) 

Ds Mask In the control Information from the lit (if _td2) 
with the function code. | 

4. Set up the Icb length word, along with the protocol 
Id. | 

oe Set the pointer to the lacs specific portion of the a 
Icb. - 

6. Call flow control routine. 

va lf a non zero status resulted In the call, retrieve 
the return address and jump back to the determination 
routine. . 

8. Clear the current [fold retry count. 

9. Increment the current fold count, {if the current count 
> the maximum count call the nak'd routine. Upon 
return from the nak'd routine return to the caller. 

10. Issue the lold. 

11. lf the Told was nak'd, go to #8. 

12. Queue the Icb on the tall of the lit active Icb queue. 

13% Return to the caller with a successful return status. 

HREEKEKEKKEKX states must be checked before an Iold can be Issued 
a 


ae 
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3.2.3 ISSUE 10 ROUTINE 


The Issue fo routine Is Invoked through a call by the 
determination routine. The routine requires the following [Input 
parameters: 


$r1 = function code 
0026 - Input Id 
0001 = start I/o 
000x - reset/halt 


$r2 = protocol Id 
$b1 = a(lit) 
$b5 = return address 


The routine supplies the following output parameters: 


$r1 = status 

0000 - Io was successful 

0001 - to not Issued because [t was nak'd 
$r2 = hardware Id if $r1 = 26 on Input 


The routine performs the following function: 


1. Save the return address 
2. Mask the function code with the If_fid2 word In the 
lit, to form the control word. 
( 2 ba Clear the current fo retry count In the Ilit.. 
4, Increment the current’ fo count, If the current count 


is greater than the maximum count, call the nak'd 
routine. Upon return from the nak'd routine return to 
the caller. 


Ds [Issue the oe 
6. lf the fo was nak'd go to #4. 
T% Return to the caller with a successful return status. 


HHHKRREKERE States must be checked before the fo Is Issued 
3.2.4 INTERRUPT PROCESSING ROUTINE 
The Interrupt processing routine is Invoked via an [nterrupt 
generated when the lacs completes an Icb. The routine requires 
the following input parameters: 
$iv.0 = [Interrupt control! word (tcb word 0) 


The routine supplies the. following output parameters: 


( terminates it's level when complete 


# 99. = 
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When the interrupt processing routine Is Invoked as a result of 
an Interrupt, It performs the following. | on 
| Ne 
1% Retrieve the Icw from $iv.o. = 
2 lf the Icw = 0, then go to an error processing routine 
(tbd). 
% Retrieve the pointer to the scb, retrieve the pointer 
to the cd from the scb. 
4. Index Into the cd by the [cw bits 0-3 for the pointer 
to the ct. 
oe Index Into the ct by the icw bits 4-6 for the pointer 
to the It. 
6. Index Into the It by the Icw bits 7-9 for the pointer 
to the lit. 
T* Retrieve the pointer to the active [cb queue from the 
lit. 
8. Search the queue starting from the head, until a 
completed Icb Is found, if no completed Icb Is found, 
terminate the leve! through a lev instruction, make 
sure the p=-counter is set to the start of this 
routine. is 
9. Dequeue the completed Icb, save the pointer to the _— 
next Icb on the queue, call the flow control routine. 
10. Retrieve the cb_Iitp word. 
11. lf bit 7 of the cb_ind word is set, cail the exec 
request task routine to request the task from the trb 
[n the cb_Itp word, with $b5 = return, $b4 = a(trb), 
and all registers saved. Restore the registers, (Cif 
an error resulted [n the call what the routine will do 
is tbd), retrieve the pointer to the next Icb In the 
queue and go to #8. 
12. lf bit 7 of the cb_itp word Is not set, Inj fo the 
address specified In the cb_Itp word, with $b5 = 
return address and $b1 = Icb, all other registers are 
saved.. Upon return restore the registers, retrieve 
the pointer to the next Icb and go to #8. 
13. [f bit 6 of the cb_itp word is set, release the memory 
of the Icb through an exec call! (tcb). Retrieve the 
pointer to the next Icb In the queue and go to #8. 
-_ 
wy 
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3.2.5 FLOW CONTROL ROUTINES 


The pre Icb fc routine [Is Invoked by the [Issue [fold routine. 
The routine requires the following Input parameters: 


$b1 = allcb) 

$b2 = alrct) 

$b3 = altt) 

$b5 = return address 


The routine requires the following output parmaeters: 


$b1 = a(lcb) 
$b2 = a(rct) 
$b3 = altt) 

$r1 = status 


0000 - ok to send Icb 
0001 - Icb queued because of flow control 
The routine performs the following function: 
1. 


3.2.6 NAK'D ROUTINE 


tbd 
{eo 
5 |SSUES 
1. Controller states 


L« Nak'd Icbfts 


a p 


a 


